Entrée de Registre Resource

Lors de l'utilisation du caractère esperluette (&) dans une définition de Ressource, il doit être spécifié comme :

&

Par exemple :

hl=en&q=%22

[Fermer]

La première chose à remarquer est que l'ensemble de l'entrée est incluse dans les balises <resource></resource>. Les balises <location> incluent les balises <text> qui génèrent un chemin d'accès unique au document. Un certain nombre de balises <location> peuvent apparaître dans une paire de balises <resource></resource>.

[Fermer]

Chaque Tag <location> génère un chemin d'accès. Au moment du traitement, chaque section <location> est évaluée, l'une après l'autre, jusqu'à ce qu'un chemin d'accès non-vide soit trouvé. Si le traitement est terminé et qu'aucun chemin non-vide n'est retourné, le titre de la Ressource est retiré du sous-menu Ressources.

[Fermer]

La balise <text> définit le texte utilisé pour construire un chemin de document. Dans l'exemple ci-dessus, le résultat de l'exécution du XML serait http://www.gbif.org/. Si un utilisateur sélectionne cette ressource dans le sous-menu Ressources, son navigateur s’ouvre et affiche la page d'accueil du GBIF.

L'exemple ci-dessus, bien qu'utile, est un peu restrictif. Idéalement, nous voulons inclure les données de l'enregistrement en cours. La balise <value> permet d'extraire des données et de les ajouter au chemin d'un document. L'exemple ci-dessous ajoute la valeur de la colonne IdeGenus comme terme de recherche pour Google :

<resource>

	<location>

		<text>http://www.google.com/search?hl=en&amp;q=</text>

		<value column="IdeGenus" format="url"/>

	</location>

</resource>

[Fermer]

La balise <value> récupère les données de l’attribut colonne spécifié (dans ce cas IdeGenus) et les extrait comme partie du chemin du document. L'attribut format indique que les données doivent être encodées selon les règles d’encodage des URL (voir http://www.rfc-editor.org/rfc/rfc1738.txt pour plus de détails sur l’encodage des URL). En effet, l’encodage garantit que les données peuvent être envoyées via une URL.

Ainsi, si la colonne IdeGenus contient Panthère, le résultat pour la ressource ci-dessus sera http://www.google.com/search?hl=en&amp;q=Panthère, ce qui lancera une recherche Google pour le terme Panthère, et affichera les résultats :

Les tags <value> et <text> peuvent être combinés pour construire des chemins d'accès complexes. Par exemple, nous voulons inclure le Genre (IdeGenus) et l'Espèce (IdeSpecies) dans la recherche Google. Pour faire apparaître les termes l'un à côté de l'autre, ils doivent être entourés de doubles guillemets (encodé %22 en URL) avec un espace entre chaque terme (encodé + en URL). La ressource suivante peut être utilisée :

<resource>

   <location>

      <text>http://www.google.com/search?hl=en&amp;q=%22</text>

      <value column="IdeGenus" format="url" />

      <text>+</text>

      <value column="IdeSpecies" format="url" />

      <text>%22</text>

   </location>

</resource>

Si nous avons comme genre Panthera et comme espèce leo, le chemin généré sera :

http://www.google.com/search?hl=en&q=%22Panthera+leo%22

qui initiera une recherche Google et donnera l'affichage suivant :

Un chemin d'accès très complexe peut être construit en utilisant les quatre tags discutés ci-dessus.

[Fermer]

La cinquième balise, <if>, est une balise conditionnelle qui permet de contrôler si un chemin de document doit être calculé. Dans l'exemple ci-dessus, nous ne voulons effectuer la recherche Google que si les champs Genre et Espèce contiennent des valeurs. La balise <if> permet de tester un champ pour qu'il soit rempli/vide ou pour une valeur donnée. Si la balise a pour valeur true, alors les balises internes sont évaluées, sinon elles sont ignorées.

Dans cet exemple, un chemin d'accès est produit seulement si les champs Genre et Espèce contiennent des valeurs :

<resource>

   <location>

      <if column="IdeGenus" filled="yes">

         <if column="IdeSpecies" filled="yes">

            <text>http://www.google.com/search?hl=en&amp;q=%22</text>

            <value column="IdeGenus" format="url"/>

            <text>+</text>

            <value column="IdeSpecies" format="url"/>

            <text>%22</text>

         </if>

      </if>

   </location>

</resource>

La balise <if> prend le nom d’une colonne pour identifier le champ à tester. L'attribut filled peut être défini sur yes ou no pour indiquer si le champ doit être rempli ou vide (respectivement). Ainsi, la balise <if column="IdeGenus" filled="yes"> est vraie si IdeGenus a une valeur. Si le champ est rempli, le traitement se poursuit avec les balises internes (dans ce cas, une autre balise <if> ), sinon tout ce qi est inclus jusqu'à la balise de fermeture </if> est ignoré.

Dans l'exemple ci-dessus, les balises <text> et <value> ne sont traitées que si les champs Genre et Espèces contiennent une valeur, sinon un chemin d'accès au document est généré. Si le chemin d'accès au document est vide, la ressource est supprimée du sous-menu Ressources (vous pouvez afficher la ressource de manière permanente en définissant l'attribut visible de la balise <resource> sur "yes", c'est-à-dire <resource visible="yes">).

[Fermer]

La dernière balise, <title>, permet de modifier le titre du menu. Vous pouvez notamment vouloir inclure des données dans la légende. La balise <title> peut inclure les balises <text>, <if> et <value>. Tout résultat généré par les balises <text> et <value>, lorsqu'elles sont incluses dans une balise <title>, remplaceront le texte titre défini dans le Registre.

L'exemple suivant développe l'exemple précédent en ajoutant les valeurs Genre et Espèce à la légende de menu affichée :

<resource>

   <location>

      <if column="IdeGenus" filled="yes">

         <if column="IdeSpecies" filled="yes">

            <text>http://www.google.com/search?hl=en&amp;q=%22</text>

            <value column="IdeGenus" format="url"/>

            <text>+</text>

            <value column="IdeSpecies" format="url"/>

            <text>%22</text>

	    <title>

		<text>Lookup Google for "</text>

		<value column="IdeGenus"/>

		<text> </text>

		<value column="IdeSpecies"/>

		<text>"</text>

	    </title>

         </if>

      </if>

   </location>

</resource>

[Fermer]

Il est possible de construire des chemins de document avancés avec une combinaison des six balises. Plusieurs balises <location> peuvent être incluses, le traitement se poursuivant jusqu'à ce qu'un chemin de document non vide soit généré.

L'exemple ci-dessous utilise les possibilités évoquées pour générer une URL Google (parmi trois) selon que les champs Genre et / ou Espèce sont remplis ou non :

<resource>

   <location>

      <if column="IdeGenus" filled="yes">

         <if column="IdeSpecies" filled="yes">

            <text>http://www.google.com/search?hl=en&amp;q=%22</text>

            <value column="IdeGenus" format="url" />

            <text>+</text>

            <value column="IdeSpecies" format="url" />

            <text>%22</text>

         </if>

      </if>

   </location>

   <location>

      <if column="IdeGenus" filled="yes">

         <text>http://www.google.com/search?hl=en&amp;q=</text>

         <value column="IdeGenus" format="url" />

      </if>

   </location>

   <location>

      <if column="IdeSpecies" filled="yes">

         <text>http://www.google.com/search?hl=en&amp;q=</text>

         <value column="IdeSpecies" format="url" />

      </if>

   </location>

</resource>

La première section <location> est utilisée si le genre et l'espèce sont fournies, la seconde section <location> si seulement le genre est fourni et la troisième si seulement une espèce est fournie. S'il n'y a ni l'un ni l'autre, le résultat est un chemin d'accès vide et la Ressource est désactivée.

[Fermer]